home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga2 / giflist.lha / GIFList.Doc < prev    next >
Text File  |  1993-11-05  |  3KB  |  95 lines
  1.  
  2.    NAME
  3.     GIFList -- Show useful informations on GIF files (V37)
  4.  
  5.    SYNOPSIS
  6.     GIFList DIR,ALL/S,LINKS/S,NOHEAD/S,COM=COMMENT/S
  7.  
  8.    FUNCTION
  9.     GIFList shows you some useful informations on the GIF files it finds.
  10.     It also has an option to automagically add a filenote containing
  11.     those informations, making it easier to remember resolution and
  12.     colours of your images or to add those informations in BBS
  13.     descriptions.
  14.  
  15.    INPUTS
  16.     DIR - Directory and/or pattern to look at.
  17.         Defaults to current directory.
  18.  
  19.     ALL/S - Follow subdirectories.
  20.  
  21.     LINKS/S - Follow also links to directories (requires ALL).
  22.  
  23.     NOHEAD/S - Don't print header text.
  24.  
  25.     COM=COMMENT/S - Add a comment (file note) to each file processed; the
  26.         format is:
  27.  
  28.         "(123╫456 78c) Old filenote, if any"
  29.           ^^^ ^^^ ^^^
  30.            |   |  colours (hence the "c")
  31.            |   +- height
  32.            +----- width
  33.  
  34.    RESULT
  35.     This is an example output from GIFList:
  36.  
  37.     Header Width  Height Col Length   FileName
  38.     ------ ------ ------ --- -------- ------------
  39.     GIF87a    274    403 256    36758 Filaments.GIF
  40.     GIF87a    320    200 256    18583 Supernova1989B.GIF
  41.     GIF87a    320    400 256    74752 Triton.GIF
  42.     ------ ------ ------ --- -------- ------------
  43.     Total: 3 files - 130093 bytes
  44.  
  45.     The fields are obvious enough, if you know what a GIF file is.
  46.  
  47.     Should any problem arise, GIFList will print an error message, either
  48.     after the offending file or at the end of it's output if the problem
  49.     was big enough to interrupt it's work.
  50.  
  51.     The possible return codes are:
  52.      - RETURN_OK    ( 0): all ok;
  53.      - RETURN_WARN  ( 5): generic error reading directory;
  54.      - RETURN_ERROR (10): wrong arguments;
  55.      - RETURN_FAIL  (20): no libraries or memory.
  56.  
  57.    NOTES
  58.     Please note that GIFList requires Kickstart 2.0 or above.  Making it
  59.     compatible with older OS releases would have been too onerous, or
  60.     would require using external libraries such as ARP.
  61.  
  62.     If you really need a 1.2/1.3 version and can't do it yourself (source
  63.     code is included), please contact the author, who will convince you
  64.     that 2.0 is too good to be missed. ;-)
  65.  
  66.    BUGS
  67.     I hope and think none serious enough to damage your computer.
  68.  
  69.     Of course, I wish to hear about the bugs you might find.
  70.  
  71.    DISTRIBUTION
  72.     This program is freeware.  You may redistribute it as long as:
  73.      - this text and the source code are included;
  74.      - you don't charge more than a nominal copying fee for distribution.
  75.  
  76.     Please state your modifications to the code with a clear comment, and
  77.     send me your modified version.  It would be a good idea to include
  78.     the original code, anyway.
  79.  
  80.     Any contribution will be greatly appreciated (I'm a poor engineering
  81.     student, you know).
  82.  
  83.    DISCLAIMER
  84.     The author does not assume any responsibility for damages which could
  85.     result by the use of this program.  The entire risk for the use of
  86.     this program is assumed by the user.
  87.  
  88.    AUTHOR
  89.     Flavio Stanchina
  90.     Loc. Montevaccino, 39
  91.     38040 Trento (Italia)
  92.  
  93.     email: 2:333/408.9@fidonet.org
  94.  
  95.